home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / othernet / fidonet / jetdemo / jetd-099.txt < prev    next >
Text File  |  1995-01-01  |  62KB  |  1,880 lines
  1. Preliminary short documentation for JetMail [Beta-Version]
  2. ==========================================================
  3.  
  4. For version: 0.99beta11
  5.  
  6.  
  7. RESTRICTIONS:
  8. =============
  9.  
  10. 1.  JetMail only works with Semper or Binkley 3.00 and higher (because
  11.     it uses the base 36 format for outbound files like IOS). We can't
  12.     supply THE-BOX support.
  13.  
  14. 2.  You have to install Binkley with domains, because JetMail is written to work
  15.     as a 5D system. All addresses in the configuration file must be 5D. You
  16.     can switch to 4D or 3D/2D for links which don't support 5D.
  17.     
  18.     ATTENTION: All domain names have to be completely LOWERCASE!
  19.  
  20. 3.  Messagetracking only works with a BTNC nodelist. The compiler for this 
  21.     nodelist is distributed with JetMail. The current version of Semper and
  22.     Binkley (3.03a/Beta-2) supports this format and is available from
  23.     2:243/6007 with BT-BETA !GNADE and other ST based systems.
  24.     
  25.     Some C source to access this nodelist type is requestable at the same
  26.     system with magic BNL-SRC.
  27.  
  28. 4.  Some TOS versions have problems with memory management. As JetMail uses
  29.     the memory manager VERY heavily, it might be necessary to use the util
  30.     FOLDR100.PRG and/or POOLFIX4.PRG in your AUTO folder. For Mag!x and KAOS,
  31.     you have to install ADDMEM.PRG in your AUTO folder.
  32.  
  33. 5.  You have to set up all three *different* inbound paths to get JetMail
  34.     work!
  35.  
  36. 6.  LED 1.03beta or higher is recommended as you can use many features
  37.     of JetMail only if you have access to the extended message flags.
  38.     ATTENTION: NoDeleteUnread doesn't work with older LED versions!
  39.  
  40. 7.  The mail flavours Direct and Immediate work only correctly with
  41.     Semper, because of a bug in BinkleyTerm, which takes the character
  42.     'D' as Immediate and has no special Direct flavour.
  43.  
  44.  
  45. CONFIGURATION
  46. =============
  47.  
  48. All configuration and system files are held in special system folder. JetMail 
  49. takes the name of the system folder from the environment variable JETMAIL or
  50. assumes .\JETMAIL if the environment variable isn't defined.
  51.  
  52. The file LED.NEW (lastread pointer for LED) is searched in the folder specified
  53. by MAILER or in the current working directory. LASTREAD.BBS (lastread pointer
  54. for QuickBBS ST) is searched in the folder specified by QBBS or in the current
  55. working directory.
  56.  
  57. Following files will be held in the system directory:
  58.  
  59. 1.  CONFIG.JM    : Main configuration file.
  60.  
  61. 2.  ROUTE.JM     : File with routing information.
  62.  
  63. 3.  DUPES.SYS    : CRC's of the last 8000 messages for dupechecking.
  64. 3b. TICDUPES.SYS : same for TIC files
  65.  
  66. 4.  MAILHIST.SYS : Statistic file of inbound and outbound traffic. 
  67.                    Just try the JetStat program.
  68.                 
  69. 5.  AREAHIST.SYS : Statistic about traffic in the echoareas.
  70.                    Also just for JetStat.
  71.  
  72. 6.  AFHELP.JM    : Helpfile for the built-in AreaFix
  73. 6b. FFHELP.JM    : same for FileFix
  74.  
  75. 7.  EXITINFO.SYS : Exit information generated after every exit
  76.                    This file can be processed by EXITINFO.TTP
  77.  
  78. 8.  FWD.SYS      : Information about waiting area request forwards.
  79.  
  80. 9.  LASTRUN.SYS  : JetMail keeps information about the time of the
  81.                    last execution in this file to recognize big system
  82.                    clock failures and then stop the system.
  83.  
  84. 10. HATCH.SYS    : Informations about files hatched by JMHatch.
  85.  
  86.  
  87. So let's now describe the format of the CONFIG.JM file. Comments are possible
  88. with a ; at the beginning of the line. Recognized separators are blanks and
  89. TABs. Pathnames could be specified with and without trailing backslash.
  90.  
  91. The order of commands has to be:
  92.  
  93. o Domain Definitions
  94. o System addresses
  95. o Link Definitions
  96.  
  97. All other commands can be used anywhere.
  98.  
  99.  
  100. SPECIFYING INBOUND/OUTBOUND DIRECTORIES
  101. =======================================
  102.  
  103. Inbound         <path>
  104.  
  105.     Directory of the normal inbound, i.e. the inbound for mail from unknown 
  106.     systems.
  107.  
  108. KnownInbound    <path>
  109.  
  110.     Directory of the inbound for known systems, i.e. systems which are listed 
  111.     in the nodelist.
  112.  
  113. ProtInbound     <path>
  114.  
  115.     Directory of the inbound for  protected systems, i.e. systems for which
  116.     you've defined a session password.
  117.  
  118.     The directories must correspond with the inbound settings for Binkley or
  119.     Semper. It is absolutely necessary to define all three inbounds to run
  120.     JetMail.
  121.  
  122. Outbound        <path>
  123.  
  124.     Defines the default outbound for your first domain. The same as the second
  125.     argument in the first domain statement of Binkley. Normally points to
  126.     'OUTBOUND'.
  127.  
  128. SECURITY
  129. ========
  130.  
  131. JetMail will handle mail as follows:
  132.  
  133. 1.  JetMail doesn't process Arcmail in Normal/Known Inbound. It just writes
  134.     a message in the log and renames the Arcmail bundles to *.Bnn. Only Arcmail
  135.     in the protected inbound will be processed by JetMail.  
  136.  
  137. 2.  Packets from not linked systems (about the concept of links, see later)
  138.     in the protected inbound are renamed to BKT. Also packets from links with
  139.     a password mismatch.
  140.  
  141. 3.  If the destination address of the packet is not our system the packet is 
  142.     renamed to BKT.
  143.  
  144.  
  145. ARCHIVERS
  146. =========
  147.  
  148.     JetMail supports the following archive formats: ARC,LZH,LHA,ZIP,ZOO,ARJ.
  149.     The syntax is very simple. Put the Keywords 
  150.  
  151.     ArcPack, ArcExtract, LZHPack, LZHExtract, LHAPack, LHAExtract, ZipPack,
  152.     ZipExtract, ZooPack, ZooExtract, ArjPack, ArjExtract 
  153.  
  154.     in your CONFIG.JM, specify the path to the compression utility after the
  155.     keyword and then the desired options for extracting or adding.
  156.  
  157.     Example: ZipPack c:\archiver\zip\zipjr.ttp -a -mt -edb
  158.  
  159.     The difference between LHA and LZH is, that LZH is for old LHARC archives
  160.     before version 2.0. Sometimes lharc 2.01 has difficulties to unpack these
  161.     archives. Normally LHA/LZH will point to the same archiver.
  162.  
  163.  
  164. SPECIAL AREAS
  165. =============
  166.  
  167. Netmail         <areaname>
  168.  
  169.     Defines the netmail area name as specified in AREAS.BBS. So, if you have
  170.     an AREAS.BBS line
  171.     
  172.     G:\MSGBASE\NETMAIL FidoNetmail
  173.     
  174.     then you would have to define
  175.     
  176.     Netmail     FidoNetmail
  177.     
  178. Mailbox         <areaname>
  179.  
  180.     Defines your private mailbox. If defined, every EchoMail directed to the 
  181.     Sysop will also be saved into this folder. JetMail will put a 
  182.     \03AREA [AreaTag] line into the message. You could reply to this mail as 
  183.     in a normal echomail area (but don't delete the special line when 
  184.     replying). JetMail will recognize the Areaname from this line when scanning
  185.     the Mailbox and saves the message back to this area if SaveLocal is active.
  186.     
  187.     'Messages to sysop' pointers won't be set in the normal echomail when
  188.     mailbox is defined.
  189.     
  190.     The definition is done as for Netmail.
  191.     
  192.     ATTENTION: This area has to be defined in AREAS.BBS, too!
  193.     
  194. BadMsgs         <areaname>
  195. DupeMsgs        <areaname>
  196.  
  197.     These keywords define areas for unprocessable messages and for dupes.
  198.     If DupeMsgs is not set, dupes will be saved into the BadMsgs area. If
  199.     also BadMsgs remains undefined, dupes are thrown away.
  200.     
  201.     The definition is done as for Netmail.
  202.     
  203.     ATTENTION: These areas have to be defined in AREAS.BBS, too!
  204.  
  205. Archive         <filename>
  206.  
  207.     Defines the area to which msgs are copied which had the Archive/Sent flag
  208.     set when exporting. This flag is supported by LED 1.03beta and higher.
  209.     
  210.     ATTENTION: This area has to be defined in AREAS.BBS, too!
  211.  
  212. SPECIFYING DOMAINS AND NETWORK ADDRESSES
  213. ========================================
  214.  
  215.     This is in my opinion the most difficult part in configuring JetMail. As 
  216.     i mentioned in the introduction, it is not possible to run JetMail without
  217.     using domains.
  218.  
  219. Domain          <name>    <abbrev>    <official>
  220.  
  221.     as it said, <name> is the name of the domain like fidonet.org or nest.ftn.
  222.     <abbrev> is the shortening of the domain name and is used to identify the
  223.     outbound folder for mailpackets like in Binkley (NOTE: This isn't true for 
  224.     the first domain. JetMail takes the Outbound folder instead of). It is also
  225.     used for FSC0045 packets. <official> could be anything and is used to plot 
  226.     the 'NiceOrigin' line.
  227.     
  228.     Example:  Domain nest.ftn nest NeST
  229.     
  230.     nest.05a will now be the outbound folder for NeST mailpackets. The Origin
  231.     line will be (90:4/0@nest.ftn) or (NeST 90:4/0) if you specify NiceOrigin.
  232.     Please note that 'abbrev' must correspond with the second parameter in 
  233.     Binkleys domain statement. If you send FSC0045 packets, JetMail puts 'nest'
  234.     into the OrigDomain field of the mailpacket.
  235.     
  236.     ATTENTION:  The <name> parameter will be automatically converted to
  237.                 lowercase to maintain conformity with the domain standards.
  238.  
  239. Address         <full_5D_address>       [fakenet]
  240.  
  241.     You specify all your network addresses with this statement. Please encourage, 
  242.     that you really define all your addresses. Otherwise JetMail routes mail to
  243.     a not known AKA of you. <fakenet> is only necessary for mail to points with 
  244.     only 3D capable software (SEEN-BY entry).
  245.     
  246.     Example: Address 2:2456/114@fidonet.org  29114
  247.              Address 51:601/111@atarinet.ftn
  248.              Address 90:400/602@nest.ftn
  249.  
  250.  
  251. FLAGS & MISCELLANEOUS
  252. =====================
  253.          
  254. Debug           <flags>
  255.  
  256.     Specifies stages of debugging.
  257.     
  258.     Global        1
  259.     Import        2
  260.     Scan          4
  261.     Pack          8
  262.     Maint         16
  263.     Control flow  32
  264.     
  265.     Just add the values. For example: Debug 6 enables debugging of
  266.     scanner and importer.
  267.     
  268.     The 'flow' debug is logging the internal program trace. This should be
  269.     used if JetMail bombs reproducable. The log should be sent to the
  270.     authors.
  271.  
  272. Sysop           <name>
  273.  
  274.     Your Sysop name. Needed for setting 'Messages to sysop flag' in LED. Also
  275.     checked against your keyfile. 
  276.  
  277. Key             <serialnumber>
  278.  
  279.     With that keyword, you install your personal registration key or demo key.
  280.     Without that key, JetMail won't work.
  281.  
  282. Logfile         <filename> [maxsize]
  283.  
  284.     Name of the JetMail logging file. Defaults to LOGFILE.JM in the system
  285.     directory. If you specify maxsize (in KB), the built-in logfile trimmer
  286.     is activated. If the logfile grows above maxsize KB, the logfile is trimmed
  287.     to 3/4 of the former size.
  288.  
  289. NoLog           <flags>
  290. NoDisplay       <flags>
  291.  
  292.     Disables partially the logging of messages. Possible flags are:
  293.  
  294.     ~ : Miscellaneous
  295.     ! : Fatal error
  296.     ? : Warning
  297.     + : Major change
  298.     - : Minor change
  299.     = : Routing information 
  300.     # : Bundle information
  301.     * : Message logging
  302.     % : Results
  303.     $ : Bundle/Packet sizes
  304.     > : Debug information
  305.     & : Internal program flow information for debugging purposes
  306.     / : AreaFix messages
  307.  
  308.     Example: NoDisplay *% disables displaying of message logging and result 
  309.              information
  310.  
  311. VerboseLogging
  312.  
  313.     This one lets JetMail log all processed areas by MAINT and SCAN, for
  314.     debugging purposes.
  315.  
  316. BinkleyLog
  317.  
  318.     Switches to Binkley-style logging format. For people which use the same
  319.     logfile for Binkley and JetMail.
  320.  
  321. Nodelist        <path>
  322.  
  323.     Tells JetMail the path to a BNL nodelist base as compiled with
  324.     BTNC.
  325.  
  326. StdDays         <number>
  327. StdMinMsgs      <number>
  328. StdMaxMsgs      <number>
  329.  
  330.     Standard values for crunching echomail when not defined in AREAS.BBS.
  331.     Defaults to 21 days, 0/1500 messages.
  332.     
  333. KeepBundles
  334.  
  335.     Rename Arcmail bundles to *.nnn after importing. Don't delete them.
  336.  
  337. MinDiskSpace    <number>
  338.  
  339.     Check diskspace before writing to a file. Measure is in KB.
  340.  
  341. MSGIDMode       <2D|3D|4D|5D>
  342.  
  343.     Mode of MSGID for locally entered messages. Defaults to 5D if not 
  344.     specified.
  345.  
  346. OriginMode      <2D|3D|4D|5D>
  347.  
  348.     Mode of Origin for locally entered messages. Defaults to 4D if not 
  349.     specified.
  350.  
  351. NoSaveLocal
  352.  
  353.     JetMail saves back locally written messages after exporting. This option
  354.     disables this feature if you have trouble with old out-dated software.
  355.  
  356. CheckEchoDupes   [<count>]
  357.  
  358.     Activates echomail dupechecking. JetMail keeps up the CRCs of the
  359.     last 8000 imported echomail messages for dupe checking. If 8000
  360.     is not enough, you can specify <count>.
  361.  
  362. CheckNetDupes
  363.     
  364.     Activates netmail dupechecking. The Via lines are checked if the netmail
  365.     has already passed our system.
  366.  
  367. DefPktType      <FTS0001|FSC0039|FSC0045|FSC0048>
  368.  
  369.     Default packet header type for mail to systems which are not links (normally
  370.     for crashmail). Defaults to FTS0001 which nearly every known mailprocessor
  371.     accepts.
  372.     
  373. NoMsgTrack
  374.  
  375.     Deactivates the built-in message tracker. The tracker checks if the
  376.     origin and destination of a netmail is listed and bounces it if not.
  377.     
  378.     The message tracker is only available with the full key.
  379.     
  380. KnownAddress     <patterns...>
  381.     
  382.     If you want declare some address(es) as "listed" which are not really
  383.     in the listed nodelist, you can do it with this statement. The built-in
  384.     message tracker treats them as "listed". So if you run a nodelist
  385.     with zone 2 compiled only and you route netmail to other zones
  386.     to your uplink, you don't want those netmails to checked by your
  387.     message tracker. With
  388.     
  389.     KnownAddress  1:*@fidonet.org 3:*@fidonet.org 4:*@fidonet.org
  390.     KnownAddress  5:*@fidonet.org 6:*@fidonet.org
  391.     
  392.     you can prevent those netmails to be bounced.
  393.     
  394. VacationDate    <date>
  395.  
  396.     Put here some information if you are on holiday. For every netmail to
  397.     you, JetMail takes the date after VacationDate and sends a short message
  398.     to the originator of the netmail including this date.
  399.  
  400.     Example:
  401.     
  402.     Vacationdate 31.12.1992
  403.     
  404.     You can exclude mail robots via "Robots".
  405.             
  406. ReAddress       "to_pattern" <address_pattern> "new_to" <newaddress_pattern> [NoNotify]
  407.  
  408.     ReAddresses netmail. Every netmail which destination address is matched by
  409.     <address_pattern> and To field matched by "to_pattern" will be redirected.
  410.     The To: field is changed to <new_to> (unchanged if <new_to> is *) and all
  411.     components of the destination address are changed to <newaddress_pattern>.
  412.     
  413.     In the <newaddress_pattern> parameter, all components of a 5D address must
  414.     be defined. You can leave out the .0 for nodes!
  415.     
  416.     Example: 
  417.     
  418.     ReAddress "*" 2:241/*@fidonet.org "Joerg Spilker" *:*/*.1@fidonet.org
  419.     
  420.     JetMail redirects every netmail to a system in net 241 to Joerg Spilker and
  421.     changes the point number to 1 in the address fields (not very useful :-))
  422.     
  423.     Also, you are able to modify, not just replace the To: string. In
  424.     the place of '*' in the new_to parameter, the old To: name is
  425.     inserted, so e.g. Albi Rebmann can use the following for his Zerberus
  426.     gateway
  427.     
  428.     ReAddress "*" 77:7700/430.0@LifeNet "*@CREDO.ZER" 77:7700/1.0@LifeNet
  429.     
  430.     to append @CREDO.ZER to the To: string and re-address it to his
  431.     Zerberus gate.
  432.     
  433.     Normally, the addressee is informed about the re-addressing which has
  434.     taken place. But if you run a gateway software which uses a point
  435.     address of your node system, you would not want to have extra text
  436.     added to the message body. So you can use the optional keyword
  437.     "NoNotify" to disable this notification.
  438.     
  439.     ATTENTION: JetMail has an automatic re-addressing for your points
  440.                built-in. This works only if JetMail knows the name of
  441.                this point, so it has to be listed in the nodelist or
  442.                specified by "Sysop <name>" in the link block.
  443.                
  444.                The virtual ReAddress line used for a link like
  445.                John Doe at 1:234/56.7@fidonet.org:
  446.                
  447.                ReAddress "John Doe" 1:234/56.*@fidonet.org "*" *:*/*.7@*
  448.  
  449.     
  450. Purge   [From|To|Subject|Text]  <string>
  451.  
  452.     JetMails throws away every net- and echomail message with from/to/subject
  453.     field in the message-header containing <string>. <string> CAN'T be a
  454.     pattern like "Jonathan Dumm*" if used in conjuction with the From/To/Text
  455.     parameters. If you use Purge with "Subject" parameter, a pattern can be
  456.     specified using * or ? quantors.
  457.     
  458.     ATTENTION: The comparison is case SENSITIVE
  459.  
  460. Supervise       <name>
  461.  
  462.     JetMail copies all ECHOmail messages from or to <name> to the netmail
  463.     area and addresses them to the sysop.
  464.     
  465. FilterReqMsgs
  466.  
  467.     This flags tells JetMail to throw away all messages which the FILEREQUEST
  468.     flag set. This messages arrives usually if FD systems are requesting FILES.
  469.  
  470. NiceOrigin
  471.  
  472.     5D Origin looks like (2:245/96@fidonet.org). With NiceOrigin set, it looks
  473.     like (FidoNet 2:245/96) (the last case also with ORIGINmode = 4D).
  474.  
  475. NoReplyChains
  476.  
  477.     JetMail calculates reply chains from MSGID and REPLYID for the ReplyChain
  478.     feature of the current LED betaversions. NoReplyChains disables this
  479.     feature if you have problems with other software using mailer[0-3] message
  480.     header fields.
  481.  
  482. PrintMyMail
  483.  
  484.     Similar to ACS, this statement lets JetMail print every incoming message to
  485.     the sysop (netmail AND echomail). The printer status is checked before
  486.     every message.
  487.  
  488. PrinterLineLen   <val>
  489.  
  490.     This command sets the line length of your printer to an other value
  491.     than 70, which is the default. JetMail uses this value to wrap lines
  492.     of a paragraph if using PrintMyMail.
  493.  
  494. NoStripCrash
  495.  
  496.     JetMail strips the Crash flag while importing a netmail message and prevents
  497.     crashmails from other links to be sent via your system. This options turns
  498.     this feature off.
  499.  
  500. ImportArcmail
  501.  
  502.     This statements allows JetMail to import mail bundles in the known and
  503.     unknown inbound if specified. Default is only to import unbundled packets.
  504.     
  505.     ATTENTION: If you use this command, your system is a perfect target
  506.                for mail bombs!
  507.  
  508. NoDestCheck
  509.  
  510.     This switch turns the packet destination check of JetMail off. Some silly
  511.     software writes bad packet headers and relies on the uglyness of the
  512.     receiving system.
  513.  
  514. DisableAreafix
  515.  
  516.     Turns the built-in AreaFix off.
  517.  
  518. NoCPP
  519.  
  520.     This is used to turn the CPP (Circular Path Protection) globally off.
  521.  
  522. MonitorNetmail
  523.  
  524.     This one forces JetMail to save EVERY processed netmail into the
  525.     local netmail folder.
  526.  
  527. NoMonitor       <patterns...>
  528.  
  529.     This one is used for excepting some unwished netmails from being
  530.     monitored if using MonitorNetmail.
  531.  
  532. MonitorFix
  533.  
  534.     This one forces JetMail to save all AreaFix & FileFix (coming soon)
  535.     netmail traffic locally to your netmail area.
  536.  
  537. Interprete      <5Daddr> AS <5Daddr>
  538.  
  539.     This statement gives you the ability to translate packet
  540.     origin/destination addresses. The first address is the address
  541.     which is parsed from the packet header and which is replaced by
  542.     the second address.
  543.  
  544. Group           <groupchar>
  545. GroupEnd
  546.  
  547.     With this commands, you specify all area groups you will use in
  548.     AREAS.BBS with -Group and the <description> is listed on the top
  549.     of an AreaFix report. Within this group definition block, you can
  550.     use the following commands:
  551.     
  552.     Description <description>
  553.     Announce    <areas...>
  554.     MsgBasePath <path>
  555.     SortMode    [Sorted/Unsorted]
  556.     
  557.     If you don't define a description, the group will NOT be listed
  558.     on top of the AreaFix reports.
  559.     
  560.     Announce is used to specify areas, in which automatically added
  561.     or removed areas of this group are reported.
  562.     
  563.     If using Auto[D]Area, JetMail creates the HDR and MSG files in
  564.     the same directory where the netmail area is stored. You can now
  565.     define the path per group. Example:
  566.     
  567.     SortMode is used to switch sorted AreaFix list output on and off.
  568.     
  569.     UseNetNaming is used to activate automatic generation of
  570.     hirarchical directory structures according to the areatag if
  571.     AutoArea is used. This is useful for networks in which hirarchical
  572.     areatags are used (example: UseNet, AtariNet, NeST).
  573.     Addition of N.GER.BETA.JETMAIL would result in \N\GER\BETA\JETMAIL.HDR/MSG
  574.     and COMP.SYS.ATARI.ST in \COMP\SYS\ATARI\ST.HDR/MSG
  575.     
  576.     Group N
  577.        Description  NeST International Network
  578.        Announce     NEWECHOS.LOC
  579.        UseNetNaming
  580.        MsgBasePath  G:\MSGBASE\NEST\
  581.     GroupEnd
  582.     
  583.     Group A
  584.        Description  AtariNet - The direct link to ATARI USA
  585.        Announce     NEWECHOS.LOC
  586.        UseNetNaming.
  587.        MsgBasePath  G:\MSGBASE\ATARINET\
  588.     GroupEnd
  589.  
  590. NoAutoDisconnect
  591.  
  592.     JetMail's AreaFixer automatically disconnects passthrough-areas
  593.     which are not passed to another link at your uplink. This option
  594.     disables this feature.
  595.  
  596. CrunchAlways
  597.  
  598.     This one lets JetMail crunch the special areas FidoNetmail,
  599.     TrashArea, Dupearea and Archive everytime JetMail was invoked
  600.     with the SCAN[ALL] or PACK parameter.
  601.  
  602. MinCrunch <count>
  603.  
  604.     Tells JetMail not to compact areas in which less than <count> messages
  605.     would be removed.
  606.  
  607. NoDeleteUnread
  608.  
  609.     Tells JetMail not to delete unread messages.
  610.  
  611. KeepMemory <size>
  612.  
  613.     This one advises JetMail to leave <size> KB free memory to external
  614.     programs like archivers etc. Also very useful for multitasking environments
  615.     like MultiTOS, MiNT or MultiGEM.
  616.     
  617.     The default is to keep 400KB free.
  618.  
  619. AboutFile <file>
  620.  
  621.     This one is to define a file which will preceed every AreaFix
  622.     list report.
  623.  
  624. DupeRing
  625.  
  626.     This one enables dupe ring checking for those who have set up an
  627.     echomail backbone ring. This was made switchable because it takes
  628.     some extra time.
  629.  
  630. FreeBuffers
  631.  
  632.     Advises JetMail to free all buffers when calling archiver programs
  633.     so that there is a minimum of 84KB more free memory.
  634.     
  635.     ATTENTION: If you use a CheckEchoDupes with a high count specified
  636.                behind it, it takes a very long time to re-initialize the
  637.                buffers so the BUNDLE process on node systems can be
  638.                significally slowed down.
  639.  
  640. NoSaveSeenby
  641.  
  642.     Tells JetMail not to write SEEN-BY and PATH information into the
  643.     local message base.
  644.     
  645.     ATTENTION: This command should not be used by systems which have
  646.                echomail downlinks as rescanning is not longer possible.
  647.  
  648. LimitHandles
  649.  
  650.     This statements limits the amount of file I/O handles used by JetMail
  651.     for systems which don't support many of these. When using MiNT or
  652.     MultiTOS, JetMail automatically activates LimitHandles, but on FALCON
  653.     machines you have to do that manually if you don't run MultiTOS.
  654.  
  655. ArealistUnsorted
  656.  
  657.     Avoids alphabetically sorting your area listing in AreaFix reports.
  658.     
  659.     See also "SortMode" in the Group definition block.
  660.  
  661. StdMaxPktSize   <size in KB>
  662.  
  663.     Used to set a global maximum size for outgoing PKT files. The default
  664.     is NO limit.
  665.     
  666.     See also "MaxPktSize" in the Link definition block.
  667.     
  668.     ATTENTION: You have to limit the import buffer size with MaxBuffer to
  669.                leave some memory to the archiver program.
  670.  
  671. Robots          <patterns...>
  672.  
  673.     With that statement you can prevent JetMail from appending a signature
  674.     to addressees matching <pattern>. JetMail has the following names
  675.     hard-coded:
  676.     
  677.     o AreaFix
  678.     o AreaMgr
  679.     o JetMail AreaFix
  680.     o JetMail Server
  681.     o FileFix
  682.     o FileMgr
  683.     o Ticker
  684.     o Raid
  685.     
  686.     Example:
  687.     
  688.     Robots   *Mgr Manager *Fix GEcho
  689.     
  690.     Also, JetMail will not react on mail from these names if you are
  691.     using VacationDate. Also, no signature will be appended to netmails
  692.     to these "persons".
  693.  
  694. NoSignature     <patterns...>
  695.  
  696.     With this command, you can prevent JetMail from appending a
  697.     signature to addressees matching <patterns...>. This is very
  698.     useful if you write often netmails to mail partners who know the
  699.     information in your signature well (e.g. your uplink or boss).
  700.     
  701.     Example:
  702.     
  703.     NoSignature   *Spilker *Thieme
  704.     
  705.     ATTENTION: If you write to addressees listed behind "Robots" and
  706.                all hardcoded mail robots, they won't get any
  707.                signature. So you don't have to define these twice.
  708.  
  709.  
  710. LINK DEFINITIONS
  711. ================
  712.  
  713. Links are an elementary concept of JetMail. For every system to which you want
  714. to route mail, you have to specify characteristics like AreaFix password,
  715. Arcmail type, packettype and many more. Every link definition begins with the
  716. line:
  717.  
  718. Link            <full_5D_address> [fakenet]
  719.  
  720. and end withs the line
  721.  
  722. LinkEnd
  723.  
  724. The fakenet MUST be given if the Link is a point, and not one of yours
  725. and uses Controlmodes 2D or 3D. If he/she uses 4D or 5D Controlmodes,
  726. no fakenet is needed.
  727.  
  728. The following keywords are only active within linkdefinitions:
  729.  
  730. Sysop           <put name of link here>
  731.  
  732.     This field defines the name of the sysop. If not defined, JetMail tries to
  733.     get the sysop name from the sysop field of the nodelist. If JetMail can't
  734.     find the name in the nodelist, it puts 'Sysop' in the field. 
  735.    
  736.     This field is used for automatic replies or netmails to set the TO field
  737.     in the messageheader (instead of using "Sysop").
  738.    
  739. Password        <upto_8_chars>
  740.  
  741.     Defines packet and AreaFix password. Please note that some systems don't
  742.     include a password in the packet header. In this case defining a Password
  743.     causes a 'password mismatch' when processing the packet.
  744.  
  745. SessionPwd      <upto_8_chars>
  746.  
  747.     Defines the session password with this link if it differs from your mail
  748.     password. This one was implemented to get request responses from BinkleyTerm
  749.     systems imported which contain the session password as packet
  750.     password.
  751.  
  752. AreaFixPwd      <upto_8_chars>
  753.  
  754.     Defines an AreaFix password. Only needed when you can't specify a password
  755.     because the link doesn't support packet passwords or if you want to have
  756.     different password for AreaFix and packet.
  757.  
  758. ArcMode         [ARCmail|LZHmail|LHAmail|ZIPmail|ZOOmail|ARJmail|None]
  759.  
  760.     Specifies which archiver to use for the link. If 'None' specified,
  761.     the packets will remain uncompressed.
  762.   
  763. PackCommand     <flags>
  764.  
  765.     If defined, <flags> overrules the standard flags for compressing from the 
  766.     archiver definition.
  767.   
  768.     Example: You have an archiver definition for ZIP like this:
  769.   
  770.              ZipPack  c:\archiver\zip\zipjr.ttp -a -mt
  771.            
  772.              But you know that some systems are using ZIP 2.0 compatible archivers
  773.              and you wish to send them deflated packets. Then you put a
  774.            
  775.              PackCommand   -a -mt -edb
  776.            
  777.              in the link definition.
  778.  
  779. PktType         [FTS0001|FSC0039|FSC0045|FSC0048]
  780.  
  781.     Packetheadertype for this link. Defaults to FSC0039. This type is supported
  782.     by nearly all mailprocessors. If your link complains about the type just try 
  783.     one of the others (FSC0048 first, then FSC0045 and at last FTS0001).
  784.  
  785.     For technical information about the header types take a look into the 
  786.     FidoNet Technical Standards. These documents should be available from any
  787.     FidoNet system.
  788.   
  789. INTLMode        [2D|3D|4D]
  790.  
  791.     Defines the address type for written INTL lines. These lines are needed for
  792.     interzone mails. Defaults to 3D.
  793.   
  794. ForceINTL
  795.  
  796.     This keyword forces JetMail to write an INTL in every mail, even if the 
  797.     zone doesn't change. Some echomail processors don't assume the origin and
  798.     destination zone of a message from the zone fields in the packetheader and
  799.     use the zone of their first alias instead (or assume the zone from the MSGID
  800.     and REPLY kludges which causes trouble if the originating network wasn't 
  801.     fido compatible). This causes for example a netmail from 90:4/0 recognized
  802.     as from 2:4/0 :-((
  803.  
  804. ControlMode      [2D|3D|4D|5D]
  805.  
  806.     Defaults to 2D and describes how to write SEEN-BY and PATH into echomail.
  807.     Please use modes higher than 2D only with other JetMail systems.
  808.  
  809. OutboundMode     [2D|3D|3Dpoint|4D|5D]
  810.  
  811.     Defaults to 5D. This one should be used by systems with links which are
  812.     using mailers which are not domain/zone/point aware, because Binkley-ST
  813.     takes the first own address as default template to expand the received
  814.     remote address. OutboundMode is very useful if having links in a domain
  815.     which isn't your default domain and they're using mailers which aren't
  816.     domain/zone/point aware. Or a foreign point is a link of you and he/she
  817.     presents his/her fakenet address, 'cause he is using a BinkleyTerm-ST
  818.     version below 3.00
  819.     
  820.     Examples:
  821.     
  822.     Presented remote's address | OutboundMode
  823.     ---------------------------+-------------
  824.     24596/5                    | 2D
  825.     2:24596/5                  | 3D
  826.     245/96.5                   | 3Dpoint
  827.     2:245/96.5                 | 4D
  828.     2:245/96.5@fidonet.org     | 5D (default)
  829.  
  830. NetmailType      [2D|3D|4D]
  831.  
  832.     Describes how to export netmail. Defaults to 4D which means that for point 
  833.     addressing FMPT/TOPT and INTL lines are written into the mail (standard). 3D 
  834.     uses the fakenet to generate the message header (containing a INTL kludge if 
  835.     the mail leaves the zone). 2D only writes the fakenet into the message-
  836.     header.
  837.  
  838.     There is no difference between 4D and 3D for nodes. The difference between
  839.     3D and 2D is the existence of an INTL line when the mail leaves the zone.
  840.   
  841. EchomailType     [2D|3D|4D]
  842.  
  843.     Same as NetmailType, but for Echomail.
  844.  
  845.     NOTE: You don't need a fakenet if you specify all kind of address modes 4D
  846.     or higher.
  847.   
  848. ExtraNetmail
  849.  
  850.     Send netmail unbundled in an extra packet. Standard is to put netmail and
  851.     echomail into one packet.
  852.  
  853. RouteNetmail
  854.     
  855.     Normally, netmail for Links or their points are sent direct to them. With
  856.     this flag, you can force JetMail to route the mail via the ROUTE-TO lines
  857.     of ROUTE.JM. According to Joerg, this feature is sometimes (seldom?, hint)
  858.     useful, if you have a protected session partner, but you don't want to
  859.     force him to call you for mail.
  860.     
  861. DummyPacket
  862.  
  863.     When using the POLL command in the routing file, JetMail generates an empty
  864.     packet (you know this from ACS) if using DummyPacket. Otherwise JetMail only
  865.     writes an OFT files of 0 byte length.
  866.   
  867.     Especially some FD systems need this dummy packets because they don't send
  868.     mail to you if you don't send mail to them :-))
  869.     
  870.     If you are using Semper, the fantastic mailer by Jan Kristen, then you have
  871.     to use DummyPacket in conjunction with POLL, because Semper doesn't
  872.     recognize empty OFT files as a reason to poll that system.
  873.  
  874. AutoArea        [group]
  875.  
  876.     Adds an non-existing area automatically to your AREAS.BBS file as and
  877.     connects the system. If not set, messages in unknown areas from this link
  878.     are trashed. You can define the group which the new area will get. This
  879.     should be used to prevent a FidoNet link to connect to an NeST area which
  880.     was automatically added.
  881.  
  882. AutoDArea       [group]
  883.  
  884.     Same as AutoArea, but adds the areas to the DAREAS.BBS as passthrough
  885.     area.
  886.  
  887. FwdRequests
  888.  
  889.     Allows forward requests of areas which aren't available at your system to
  890.     other systems. This part of the AreaFix isn't finished. He will reply to
  891.     the link that the request is forwarded but it really isn't. You have to
  892.     request the area manually.
  893.     
  894. NoNotify
  895.     
  896.     Deactivates NOTIFY for this link. For nearer information, look into
  897.     the chapter about the command line.
  898.  
  899. Passive         [groups]
  900.  
  901.     Defines that the link is on vacation and wants to get only the mail
  902.     addressed to him. If <groups> is specified, only the areas of the
  903.     specified groups are passive for that link.
  904.  
  905. CrashOK
  906.  
  907.     Allows JetMail to sent Crashmails to this link (point). This flag should
  908.     be used for points which are 24 hours online. This point must be listed.
  909.  
  910. Groups          <string>
  911.  
  912.     <string> determines to which areas the link can connect. If the group char
  913.     of an area matches one char in the string then the link is allowed to 
  914.     connect to this area. The group char has to be defined with the
  915.     Group command (see above).
  916.   
  917. Aka             <full_5D_address> [fakenet] [{groups}]
  918.  
  919.     Defines an AKA for this link. What happens is that JetMail makes a copy of
  920.     the link structure and substitutes fakenet and groups in the copy with the
  921.     values from the AKA statement.
  922.   
  923.     Example:
  924.   
  925.     Aka 90:400/0@nest.ftn {Nn}
  926.     Aka 2:245/90@fidonet.org 25090 {ABC}
  927.     
  928.     ATTENTION: If you use AutoArea or AutoDArea with their optional
  929.                parameter, the default group is NOT copied to the aka
  930.                link. Instead, the first group of the {} definition is
  931.                taken.
  932.  
  933. RouteAka        <full_5D_address> [fakenet] [{groups}]
  934.  
  935.     Same as Aka, but sets the RouteNetmail flag in the link copy.
  936.                 
  937. UseAlias        <full_5D_address>
  938.  
  939.     Use <full_5D_address> for packet and message header to this link. The
  940.     address has to be one of your aliases.
  941.   
  942.     This is usefull for coordinators which more than one address in a domain. 
  943.     For example, i've the addresses
  944.   
  945.     Address 90:4/0@nest.ftn
  946.     Address 90:400/0@nest.ftn
  947.     Address 90:400/100@nest.ftn
  948.   
  949.     When sending mail to a link, JetMail will normally use the first alias with
  950.     the correct domain from this table for all links. But this can cause
  951.     difficulties if points of me get mail with headers like this:
  952.     
  953.     90:4/0@nest.ftn -> 90:400/100.1@nest.ftn
  954.     
  955.     With UseAlias 90:400/100@nest.ftn in the link defintion for this point the
  956.     right header will be set.
  957.     
  958.     For HUBs which poll me, i'll set UseAlias 90:400/0@nest.ftn
  959.     
  960.     NOTE: Don't use Aka and UseAlias in one link definition.
  961.  
  962. RemoteAreaFix   <arealistname> [<areafixname>] [!<pwd>]
  963.  
  964.     This one is to make this system available for automatic area
  965.     request forwarding and to tell JetMail's AreaFix where a list of
  966.     areas is located which are available on this link. This list will
  967.     be included in your own list of available areas on your system.
  968.     
  969.     The arealist can also be a arealist returned by a JetMail system
  970.     if used %LIST. All you have to do is to name the list with the
  971.     extension '.JET' that JetMail knows, that this is a JetMail format
  972.     list. Also, you have to remove the whole header and footer of the
  973.     message returned by %LIST and concatenate all broken descriptions so
  974.     that one line in a *.JET file contains ONE (not more, not less)
  975.     area descriptions.
  976.     
  977.     You can use "+" instead of a filename to mark a default forward host.
  978.     If you define more than one default host, the last one is choosen.
  979.     
  980.     The optional parameter <areafixname> is to define the name of the
  981.     AreaFixer on this link if it's different from "AreaFix"
  982.     
  983.     !<pwd> is an optional parameter which is useful if the remote
  984.     AreaFix is not domain aware and protects all areas from other
  985.     domains than the default one with a special password (like ACS does).
  986.     Forward requests will look like:
  987.     
  988.     NEST_AREA !pwd
  989.     
  990.     Note that all areas in the forward list for this link must be
  991.     protected with the same password.
  992.     
  993.     ATTENTION: The <pwd> parameter HAS to be leaded by "!"
  994.  
  995. RemoteAFpassword <pwd>
  996.  
  997.     This statement is used to specify the password you must use with
  998.     the remote's AreaFix.
  999.  
  1000. NoReAddress
  1001.  
  1002.     Disables automatic Re-Addressing for this link (point). See also
  1003.     the description of "ReAddress".
  1004.  
  1005. AutoConnect <patterns...>
  1006.  
  1007.     This one lets JetMail connect all matching links to a new area
  1008.     received from this link. This is useful (e.g.) for RCs who want to
  1009.     distribute a new echo automatically to all other RCs.
  1010.     
  1011.     Example:
  1012.     
  1013.     Link 90:101/0@nest.ftn
  1014.        ...
  1015.        AutoDArea N
  1016.        AutoConnect 90:400/{[1-4]00} 90:7/0
  1017.        ...
  1018.     LinkEnd
  1019.     
  1020.     This would connect Joerg's hubs and NeST Italy to every new NeST
  1021.     area Joerg receives from James Partner (90:101/0@nest.ftn).
  1022.  
  1023. NoRoute
  1024.  
  1025.     This option prevents routing any netmails to this link. This switch
  1026.     is invented for systems running gateways under a point address. The
  1027.     netmails to this link are copied to the netmail are with the
  1028.     InTransit and Orphan flags.
  1029.  
  1030. MaxPktSize
  1031.  
  1032.     Sets the maximum PKT size for that link. See also "StdMaxPktSize".
  1033.  
  1034.  
  1035. RECOGNIZED FLAGS IN AREAS.BBS
  1036. =============================
  1037.  
  1038. Scanning AREAS.BBS is one of the part of JetMail which is not as fast as the
  1039. name promises. The reason is that up to now, we don't have a binary AREAS.SYS
  1040. format. This means that every entry must be parsed and checked if it is a valid
  1041. link. But be hopeful, it's not for now and forever.
  1042.  
  1043. You needn't specfify domains in the AREAS.BBS file unless your configuration 
  1044. doesn't has two links with same numbers in different domains. JetMail will guess
  1045. the right domain from the link definition. JetMail will issue a warning when 
  1046. no link is defined for an entry in the AREAS.BBS.
  1047.  
  1048. Scanning the connected links is intelligent. Lines like the following are
  1049. possible and will lead to the expected result.
  1050.  
  1051. ATARI.GER 2:245/52@fidonet.org 96.1 .2 .3 .4 240/36 605 245/23
  1052.  
  1053.  
  1054.  
  1055. -MinMsgs        <number>
  1056.  
  1057.     Number of messages which will in all cases stay in the area even if they
  1058.     are older than specified by the -Days statement.
  1059.  
  1060. -MaxMsgs        <number>
  1061.  
  1062.     Maximum number of messages in the area.
  1063.     
  1064. -DAYS           <number>
  1065.  
  1066.     Messages older than <number> of days will be deleted on crunching.
  1067.     
  1068.     If you specify -DAYS 0, no messages will be deleted.
  1069.   
  1070.     All these values default to the messages settings in the configuration
  1071.     file if undefined in AREAS.BBS.
  1072.  
  1073. -Desc           <string>
  1074.  
  1075.     Description of the area. This one is send to users within AreaFix
  1076.     requests.
  1077.   
  1078. -ORIGIN         <string>
  1079.  
  1080.     Use <string> as origin for this area.
  1081.     
  1082. -Passthrough
  1083.  
  1084.     Area is Passthrough. Messages are distributed to the connected links but not
  1085.     saved into the local messagebase. This flag is only implemented to remain
  1086.     compatibility with ACS. JetMail uses the DAREAS.BBS file to store information
  1087.     about passthrough areas.
  1088.   
  1089. -ReadOnly
  1090.  
  1091.     This area is readonly. Only the sysop is allowed to send messages in this
  1092.     echo. Mail from other systems is trashed.
  1093.  
  1094. -Remote         <patterns>
  1095.  
  1096.     The patterns specify the systems which are allowed to send mails for
  1097.     this area. -Readonly has priority over -Remote.
  1098.     
  1099.     Example:
  1100.     
  1101.     -Remote 2:243/* 2:245/*
  1102.  
  1103. -NoRemote       <patterns>
  1104.  
  1105.     This is the negation of -Remote and works only in conjunction with it.
  1106.     
  1107.     Example:
  1108.     
  1109.     -Remote    2:243/*
  1110.     -NoRemote  2:243/114
  1111.     
  1112.     This pair allows all systems in net 243 except 243/114 to write in the
  1113.     area.
  1114.  
  1115. -Local
  1116.  
  1117.     BBS-only echo. Not scanned by JetMail.
  1118.   
  1119. -Group          <character>
  1120.  
  1121.     Classifies the group for this area. Only links with the appropiate group
  1122.     string can connect. Areas with no group specified can be connected by every
  1123.     link. Please note the problems if doing so: A link can connect a NeST area
  1124.     under his FidoNet address if the NeST areas aren't protected by special
  1125.     groups.
  1126.     
  1127.     ATTENTION: You have to assign a group to the area in order to make
  1128.                it accessible via AreaFix!
  1129.   
  1130. -UseAlias       <full_5D_address>
  1131.  
  1132.     Use this address for generating Origin/MSGID when scanning locally entered 
  1133.     messages.
  1134.   
  1135. -NoCPP
  1136.  
  1137.     Deactivates the (C)ircular (P)ath (P)rotection. This feature checks for
  1138.     duplicate system addresses in the PATH line. Trash message if so. Should not
  1139.     be used by ZoneGates. -NoCPP disables this check.
  1140.  
  1141. -Signature      <filename>
  1142.  
  1143.     Take signature from the file for locally entered messages. Like the 
  1144.     .signature file for UseNet newsreaders.
  1145.     
  1146.     ATTENTION: To prevent problems with automatic netmail utilities,
  1147.                JetMail doesn't append -Signatures in netmails to
  1148.                AreaFix, JetMail AreaFix, AreaMgr or FileFix.
  1149.  
  1150. -StripSeenby
  1151.  
  1152.     Strip SEEN-BY lines in this areas. Only usefull for ZoneGates.
  1153.     !!!!!!!!!!!!!!!!!! Must be permitted by the ZC !!!!!!!!!!!!!!!
  1154.     
  1155.     If you've got a permission, you should contact us. You'll get a special
  1156.     JETMAIL.KEY which enables this feature.
  1157.  
  1158. -NoSaveSeenby
  1159.  
  1160.     Same as global command NoSaveSeenby, but only for that specific
  1161.     area.
  1162.     
  1163.     ATTENTION: Rescanning of this area is no longer possible!
  1164.  
  1165. -Pseudonym <name>
  1166.  
  1167.     This one lets you use a pseudonym in an area when exporting
  1168.     locally entered messages. The From: field is filled with this
  1169.     <name>.
  1170.  
  1171. -AllowPvt
  1172.  
  1173.     This one allows private messages in this area. If not used, the
  1174.     Pvt flag is stripped while the next crunching process of this area
  1175.     or while scanning this message.
  1176.  
  1177. -NoHistory
  1178.  
  1179.     This flag prevents the area to be listed in the JetMail history
  1180.     files and JetStat charts.
  1181.  
  1182. -NoConnect [patterns...]
  1183. -NoDisconnect [patterns...]
  1184.  
  1185.     These ones are to avoid connecting/disconnecting via AreaFix for
  1186.     the systems matching one of the patterns. If no pattern is
  1187.     specified, nobody can (dis)connect.
  1188.     
  1189.     -NoConnect implies -NoForce
  1190.  
  1191. -ForcePvt
  1192.  
  1193.     This one lets JetMail set ALWAYS the Private flag of all messages
  1194.     in this area when crunching it.
  1195.     
  1196.     ATTENTION: This area MUST have the -Local flag set!
  1197.  
  1198. -Password <pwd>
  1199.  
  1200.     This one is to set a special area password. This password has to
  1201.     be specified when connecting this area after a "!" sign.
  1202.  
  1203. -NoDeleteUnread
  1204.  
  1205.     Same as the global NoDeleteUnread, but only for THIS area.
  1206.  
  1207. -GateTo <areas...>
  1208.  
  1209.     With this option you can gate the area with others.
  1210.  
  1211. -ForceConnect <patterns...>
  1212.  
  1213.     This option forces certain links to connect to this area. A matching
  1214.     ForceConnect pattern implies a -NoDisconnect for this link.
  1215.     
  1216.     Example: -ForceConnect 90:?/0@nest.ftn
  1217.     
  1218. -NoForce <patterns>
  1219.  
  1220.     This command is used to make exceptions to -ForceConnect
  1221.  
  1222. -NoExport
  1223.  
  1224.     Avoid SCANning this area. This is useful if an echo is read-only
  1225.     for YOU and you want to prevent sending messages by mistake.
  1226.  
  1227. -OriginalEcho <name>
  1228.  
  1229.    With this option, you can define the <name> of the area under which the
  1230.    area is known to the network. So you can run UseNet's COMP.SYS.ATARI.ST
  1231.    as CSAST by defining:
  1232.    
  1233.    -OriginalEcho COMP.SYS.ATARI.ST
  1234.    G:\MSGBASE\INTERNET\CSAST CSAST  2:2456/95@fidonet.org
  1235.    
  1236.    So, LED users are able to distinguish very long area names.
  1237.  
  1238.  
  1239. ROUTING / EVENTS
  1240. ================
  1241.  
  1242. All kind of routing information is hold in an extra file names ROUTE.JM in the
  1243. system directory. In this file, you will define the mail flavour for systems.
  1244. You can change mail flavour to certain times with the Event feature. Mail
  1245. flavour can be defined seperately for Netmail and Echomail.
  1246.  
  1247. Please note, that all matching of addresses is done on a 5D basis. You will
  1248. find some examples later in this chapter.
  1249.  
  1250. Wildcards
  1251. ---------
  1252.  
  1253. JetMail accpets the following wildcards:
  1254.   
  1255. *               : matches anything
  1256. ALL             : same as *, but only active in ROUTE.JM
  1257. ?               : matches one char
  1258. [x-y]           : matches characters x through y
  1259. {str1,..,strN}  : matches str1 through strN
  1260.                   (where the strings CAN'T contain wildcards).
  1261.  
  1262. Examples:
  1263.   
  1264. 2:245/5[0-18-9]
  1265.   
  1266. is matched by 2:245/50, 2:245/51, 2:245/58 and 2:245/59
  1267.   
  1268. 2:243/{95,600}
  1269.   
  1270. is matched by 2:243/95 and 2:243/600
  1271.  
  1272. Events
  1273. ------
  1274.  
  1275. You can enable parts of the routing file only to specific times by enclosing
  1276. lines with Event ... EndEvent. The exact syntax is:
  1277.  
  1278. Event Day <start_time> <end_time>
  1279.  
  1280.     routing information
  1281.  
  1282. EndEvent
  1283.  
  1284.     Times are in the format hh:mm. Allowed days are: Mon, Tue, Wed, Thu, Fri, 
  1285.     Sat, Sun, WkDay and WkEnd. WkDay means from Mon to Fri and WkEnd stands for
  1286.     Sat and Sun. A syntax like Mon|Tue isn't possible at the moment. Only events
  1287.     with the All identifier may extend over midnight. The lines between Event
  1288.     and EndEvent are only parsed when system time is between start_time and 
  1289.     end_time. 
  1290.     
  1291.     ATTENTION: Place the events to the end of of ROUTE.JM, because the LAST rule
  1292.     is taken!
  1293.     
  1294. Changing of mail flavour
  1295. ------------------------
  1296.  
  1297. CHANGE          <flavour> TO <flavour>  <links>
  1298.  
  1299.     where <flavour> is one of the following: HOLD, NORMAL and CRASH. links must be
  1300.     defined in the link section of CONFIG.JM otherwise JetMail issues a warning.
  1301.     
  1302.     This command only affects bundles, packets and file requests, but not file-
  1303.     attaches and TICs (?FT).
  1304.  
  1305. CHANGE-FILE     <flavour> TO <flavour>  <links>
  1306.  
  1307.     Same as CHANGE but for fileattaches (?FT).
  1308.  
  1309.  
  1310. Routing
  1311. -------
  1312.  
  1313. ROUTE-TO        <destination-link> <patterns>
  1314.  
  1315.     Every netmail which destination address matches one of the <patterns> is
  1316.     routed to the <destination-link>. 
  1317.     
  1318.     Every <pattern> must match a 5D address. Some parts of a <pattern> are set
  1319.     by JetMail if not specified so that the pattern will match a 5D address.
  1320.     
  1321.     a) JetMail takes a missing zone from your first alias.
  1322.     
  1323.     b) A missing domain is taken from the first link with the same zone as in
  1324.        the pattern.
  1325.     
  1326.     c) If point is missing, * is taken.
  1327.     
  1328.     Example:
  1329.     
  1330.     245/52      -> 2:245/52.*@fidonet.org
  1331.     2:245/52.0  -> 2:245/52.0@fidonet.org
  1332.     90:101/0    -> 90:101/0.*@nest.ftn 
  1333.     90:*        -> 90:*.*@nest.ftn
  1334.     90:400/*    -> 90:400/*.*@nest.ftn
  1335.  
  1336.     Please note that specifying .0 in a <pattern> will cause only mail to THIS 
  1337.     system routed to <destination-link>. Mail to points of this node don't pass 
  1338.     the pattern matcher!!!!!!
  1339.     
  1340.     Specify FIRST the GENERAL routing and then the special cases (like in
  1341.     ACS and in opposite to IOS).
  1342.  
  1343. FORWARD-FROM    <patterns...>
  1344. FORWARD-TO      <patterns...>
  1345.  
  1346.     to limit netmail distribution only from/to certain portions of the
  1347.     whole network. If these statements aren't used, all netmail is
  1348.     routed to all destinations.
  1349.  
  1350. HOLD-FOR        <patterns...>
  1351.  
  1352.     Put NETmail on hold for all systems matching <patterns>.
  1353.  
  1354. CRASH-TO        <patterns...>
  1355.  
  1356.     Send NETmail to systems matching <patterns> crashed.
  1357.  
  1358. IMMEDIATE-TO    <patterns...>
  1359.  
  1360.     Send NETmail immediately to systems matching <patterns>.
  1361.  
  1362. DIRECT-TO       <patterns...>
  1363.  
  1364.     Send netmail to systems matching <patterns> directly to the
  1365.     destination system, same as if you set the Direct extended message
  1366.     flag.
  1367.     
  1368.     This command is the same as NO-ROUTE in ACS and others.
  1369.  
  1370. POLL            <links...>
  1371.  
  1372.     POLL defines, that you want to poll these links. In <links>, you CAN'T
  1373.     use patterns! You have to define the address(es) without * and ?
  1374.     
  1375.     If no bundle or packet is present, an empty flow file (*.OFT) is created
  1376.     to force BinkleyTerm to call these links in the mail events. If DummyPacket
  1377.     is set, JetMail creates an empty packet instead.
  1378.     
  1379.     If using POLL, JetMail generates normal outbound mail (OAT).
  1380.  
  1381. PICKUP          <links...>
  1382.  
  1383.     PICKUP is generally the same as POLL, but it doesn't force Binkley to
  1384.     poll. The links are only polled if mail is waiting for them.
  1385.     If using PICKUP, JetMail generates normal outgoing mail (OAT).
  1386.  
  1387. CRASH           <links...>
  1388.  
  1389.     Tells JetMail that you want to deliver all mail for these links
  1390.     crash. It generates CAT bundles.
  1391.  
  1392. HOLD            <links...>
  1393.  
  1394.     Tells JetMail that you want to put mail for these links on hold.
  1395.     This is the default if no POLL/PICKUP/CRASH is specified for a
  1396.     link. As you may already noticed, this statement is obsolete but
  1397.     is left in JetMail to remain highest compatibility to routefiles
  1398.     of other software.
  1399.     
  1400.     To make the differences clear between the statements with and
  1401.     without FOR/TO, some examples:
  1402.     
  1403.     DIRECT-TO 2:245/52.0@fidonet.org
  1404.     
  1405.     Puts echomail on hold (default) for the link and sends netmail as a normal
  1406.     mailpacket.
  1407.     
  1408.     POLL 2:243/95@fidonet.org
  1409.     CRASH-TO 2:243/95@fidonet.org
  1410.     
  1411.     NORMAL ECHOmail and sends NETmail CRASHed. If binkley runs an
  1412.     appropriate event, the poll is done wether you have mail to send
  1413.     or not.
  1414.         
  1415.     CRASH 2:243/95@fidonet.org
  1416.     HOLD-FOR 2:243/95@fidonet.org
  1417.     
  1418.     Sends ECHOmail CRASH to the link and puts NETmail on HOLD.
  1419.     
  1420.     HOLD-FOR/CRASH-TO/DIRECT-TO and IMMEDIATE-TO statements applies
  1421.     BEFORE routing!!!
  1422.     
  1423. DENY            <patterns>
  1424.  
  1425.     Don't process mail from systems matching <patterns>. The packets are
  1426.     renamed to *.DEN and imported, if no DENY is active for the originating
  1427.     system anymore. This statement can be used in mail events when
  1428.     using small call slots and your machine should not be busy
  1429.     processing received mail.
  1430.  
  1431. MOVE-MAIL       <destlink> <links...>
  1432.  
  1433.     All mail packets for <links...> are compressed into the bundle
  1434.     of <destlink>. This is useful for links with more than one network
  1435.     address, but his mailer can't handle this properly.
  1436.  
  1437. FILE-FROM       <patterns>
  1438.  
  1439.     Allows file routing from all systems matched by <patterns>.
  1440.  
  1441. FILE-TO         <patterns>
  1442.  
  1443.     Allows file routing to all systems matched by <patterns>.
  1444.  
  1445. FILE-MAX        <val> <patterns>
  1446.  
  1447.     Only files smaller than <val> in kilobytes (1024 bytes) are routed
  1448.     from/to the systems matched by <patterns>.
  1449.  
  1450. HOLD-MAX        <val> <patterns>
  1451.  
  1452.     This one defines the maximum amount of mail laid on hold for links
  1453.     matching <patterns>. <val> must be defined in kilobytes (1024 bytes).
  1454.     If a link exceeds his limit, the link flag "Passive" is set.
  1455.  
  1456. USE-ALIAS       <alias> <patterns>
  1457.  
  1458.     This one advises JetMail to use <alias> as From-address in netmail
  1459.     messages destinated to systems which match the specified patterns.
  1460.     This feature is similar to ACS's Key command.
  1461.  
  1462. EXCEPT          <patterns>
  1463.  
  1464.     With this command you can define exceptions to a one of these
  1465.     preceeding commands:
  1466.     
  1467.     HOLD-FOR
  1468.     DIRECT-TO
  1469.     CRASH-TO
  1470.     IMMEDIATE-TO
  1471.     DENY
  1472.     FILE-FROM
  1473.     FILE-TO
  1474.     FILE-MAX
  1475.     HOLD-MAX
  1476.     FORWARD-FROM
  1477.     FORWARD-TO
  1478.     
  1479.     Example: You want to delived netmail to the USA directly to it's
  1480.     destination. But netmail to net 205 should go it's normal route
  1481.     path. Then you have to define
  1482.     
  1483.     DIRECT-TO 1:ALL@fidonet.org
  1484.     EXCEPT 1:205/ALL@fidonet.org
  1485.  
  1486.  
  1487. STATISTICS
  1488. ==========
  1489.  
  1490. JetMail will write a statistic of inbound/outbound mail traffic and traffic
  1491. in the areas into the files INBOUND.HIS, OUTBOUND.HIS, ECHOMAIL.HIS and
  1492. TOP10.TXT
  1493.  
  1494. Simply try the JetStat programm. It's really nice. It must be placed
  1495. to the same place of JETMAIL.TTP if the environment variable JETMAIL
  1496. is NOT set.
  1497.  
  1498. You can pass "ASCII" to JetStat in the command line. The boxes of TOP10.TXT
  1499. are then drawn with ASCII characters.
  1500.  
  1501.  
  1502. COMMANDLINE
  1503. ===========
  1504.  
  1505. JetMail accepts the following options on the commandline (you can use more
  1506. than one of them at the same time seperated by a blank):
  1507.  
  1508. IMPORT/TOSS
  1509.     
  1510.     Import mail packets and distribute to connected systems. Don't bundle
  1511.     the packets. They just stay as *.TMP files in the outbound folders.
  1512.  
  1513. BUNDLE
  1514.  
  1515.     Bundles all *.TMP files in the outbound folders.
  1516.  
  1517. PACK
  1518.  
  1519.     Scan netmail for messages and export them.
  1520.  
  1521. SCAN
  1522.  
  1523.     Scan changed echomail areas for messages and export them.
  1524.     The archive bit will be used for determining if the area has been
  1525.     changed.
  1526.     
  1527.     Because of a "misdesign" in TOS versions below 1.04, JetMail isn't
  1528.     able to detect changed areas and because of this, SCAN will act
  1529.     like SCANALL.
  1530.  
  1531. SCANALL
  1532.  
  1533.     Same as scan. But scan all echomail areas.
  1534.  
  1535. MAINT/CRUNCH
  1536.  
  1537.     Crunch messagebase according to days/max and minmessages.
  1538.     
  1539.     Example of a logfile line:
  1540.     
  1541.     - 23:27:00  NET_DEV (8/175)
  1542.     
  1543.     In NET_DEV, 8 messages were deleted and 175 are remaining.
  1544.  
  1545. TICK
  1546.  
  1547.     Activates JetMail's TIC file processor. Also advises JetMail
  1548.     to process hatched files (using JMHatch).
  1549.     
  1550.     See TICKDOC.TXT for further informations.
  1551.  
  1552. NOTIFY
  1553.  
  1554.     Sends a netmail to all links with their link parameters like Arcmailtype,
  1555.     Packettype, used AKA for this system and link flags like Passive, AutoArea,
  1556.     FwdRequests and Dummypacket status. It also sends a little inbound/outbound
  1557.     statistic.
  1558.     
  1559.     NOTE: The notify message is only send to links, for which the
  1560.           "NoNotify" flag is NOT active.
  1561.  
  1562. REPORT
  1563.  
  1564.     Writes a system report message into the netmail folder with some
  1565.     configuration data.
  1566.  
  1567. AREA=<name>
  1568.  
  1569.     Limit SCAN and MAINT to <area>.
  1570.  
  1571. LABEL=<name>
  1572.  
  1573.     Activate label <name> in the ROUTE.JM files.
  1574.     
  1575.     Labels are used as following:
  1576.     
  1577.     Label <name>
  1578.     [commands]
  1579.     EndLabel
  1580.  
  1581. REMOVE=<name>
  1582.  
  1583.     Allows you to remove an area from [D]AREAS.BBS. All links of that
  1584.     area will get an automatic AreaFix disconnect request.
  1585.     
  1586. +wait
  1587. -w
  1588. /w
  1589.  
  1590.     Wait for keypress after execution
  1591.     
  1592. +logfile <filename>
  1593. -l <filename>
  1594. /l <filename>
  1595.  
  1596.     specify other logfile.
  1597.     
  1598. ALL
  1599.  
  1600.     Short for IMPORT SCAN PACK BUNDLE MAINT
  1601.  
  1602.  
  1603. JETMAIL INTERFACE FOR ROUTING FILES
  1604. ===================================
  1605.  
  1606. JetMail has a build in interface for routing files. JetMail will look for
  1607. a special netmail message flag and when scanning the netmail. Please
  1608. contact Daniel Roesen (2:2456/114@fidonet.org or 90:400/602@nest.ftn
  1609. or 51:601/111@atarinet.ftn) for further information.
  1610.  
  1611.  
  1612. JETMAIL NETMAIL GATEWAY TO OTHER DOMAINS
  1613. ========================================
  1614.  
  1615. There is a built in interface to send mails to other domains in FidoNet
  1616. technology networks for systems which no direct access to this network.
  1617.  
  1618. Example: Daniel Roesen had no NeST access. But he wanted to send mail to some
  1619. NeST system (and he doesn't know the FidoNet address). His boss (or the host
  1620. of net 2456) bounced the mail back to Daniel because their messagetrackers
  1621. didn't know anything about zone 90.
  1622.  
  1623. What could he do? It's very easy. He just wrote a netmail like this:
  1624.  
  1625. From: Daniel Roesen on 2:2456/114
  1626. To:   Gateway on 2:243/6007
  1627. ------------------------------------------------------------------------------
  1628. To: Daron Brewood % 90:1/0@nest.ftn
  1629.  
  1630. Hi Daron, ..............
  1631.  
  1632.  
  1633. JetMail changes the message to
  1634.  
  1635. From: Gateway on 90:4/0
  1636. To:   Daron Brewood on 90:1/0
  1637. ------------------------------------------------------------------------------
  1638. From: Daniel Roesen % 2:2456/114@fidonet.org
  1639.  
  1640. and distributes it to the destination address. If Daron decides to reply he just
  1641. changes the word From: to To:
  1642.  
  1643. You can leave out the '%' if you want, JetMail understands both formats.
  1644.  
  1645.  
  1646. JETMAIL SERVER
  1647. ==============
  1648.  
  1649. JetMail has a built-in remote maintenance function for your system. If you know
  1650. FDServer (FrontDoor), you should know what I mean.
  1651.  
  1652. The server function is activated with
  1653.  
  1654. ServerPassword  <password>
  1655.  
  1656. You can write a netmail to "JetMail Server" on your own system with this
  1657. password in the subject line. The whole contents of the message (without kludges
  1658. is written to a file SERVER.BAT in the JetMail system directory.
  1659.  
  1660. This Batchfile can be executed by your main BBS batchfile.
  1661.  
  1662. ATTENTION:  If JetMail receives a server netmail, the contents is APPENDED
  1663.             to a probably existing SERVER.BAT, so you have to delete the file
  1664.             in your main BBS batchfile.
  1665.  
  1666. NEW INTEGRATED TICKER
  1667. =====================
  1668.  
  1669. New flags for the general CONFIG.JM part
  1670. ========================================
  1671.  
  1672. TICTemp         <path>
  1673.  
  1674.     Path were generated TIC files are stored.
  1675.    
  1676. DisableFilefix
  1677.  
  1678.     Disable the internal FileFix.
  1679.    
  1680. CheckTickDupes
  1681.  
  1682.     Check for dupe files. This is done like in echomail by a CRC which are
  1683.     stored in a TICDUPES.SYS file.
  1684.  
  1685.     [not yet implemented]
  1686.  
  1687. AutoSend        <Name>  <Area>  <File>  <Description>
  1688.  
  1689.     Send files automatically to the network. <Name> is the ID for the auto-
  1690.     sending. The Autosend can be activated via a special flag in the command
  1691.     line and the <Name>. <Area> is the area where the files are send into.
  1692.     <File> is the specification for the files that should be send to the
  1693.     network. It can contain wildcarts (but JetMail will only send the
  1694.     first matching file found). <Description> will be used as the
  1695.     file description.
  1696.    
  1697.     Example:
  1698.    
  1699.     AutoSend    NeSTList  90_LIST D:\TMP\NESTLIST.Z* NeSTList for day ###
  1700.    
  1701.     Attention: You can use multiple AutoSends with the same <Name>!
  1702.    
  1703.  
  1704. New flags for link definitions
  1705. ==============================
  1706.        
  1707. FilefixPwd      <pwd>
  1708.  
  1709.     Password to be used for fileecho maintenance via filefix. This password
  1710.     is set to Password or AreafixPwd if not defined.
  1711.    
  1712. TicPassive      [groups]
  1713.  
  1714.     Set groups passive. No file arriving (in the specified groups) is send
  1715.     to the link.
  1716.  
  1717. AutoTICArea     <group>
  1718.  
  1719.     Allow autoadding of TIC areas for this link. The area is added with
  1720.     <group> group.
  1721.    
  1722. NoTicNotify
  1723.    
  1724.     Do NOT send a file reminder netmail for every file sent to a node.
  1725.  
  1726. CompressTICs
  1727.  
  1728.     Bundle all TICs for that system into one archive. The compression
  1729.     method of ArcMode is used.
  1730.  
  1731.     [not yet implemented]
  1732.  
  1733.  
  1734. ATTENTION !!!
  1735.  
  1736. The password in the TIC file is similar to the password used in mailpackets.
  1737. For this reason, JetMail uses the mailpassword defined in the link 
  1738. definition also as password for the TIC file.
  1739.  
  1740. Only if there is no mailpassword available JetMail will use the filefix 
  1741. password for the TIC's.
  1742.  
  1743. If this is causing problems please tell us. We will implement a special
  1744. TICpassword command in this case.
  1745.  
  1746. ==========================================================================
  1747.  
  1748. There are some new flags/statements for the Group definitions. These
  1749. flags are mainly for announcing processed files:
  1750.  
  1751. TicGroup
  1752.  
  1753.     Declares this group as a TIC group. Without this statement the group
  1754.     would be treated as an echomail group.
  1755.  
  1756. Header     <full_filename>
  1757.  
  1758.     Header to be placed before any fileannouncement.
  1759.  
  1760. Footer     <full_filename>
  1761.  
  1762.     Footer to be placed after any fileannouncement.
  1763.  
  1764. Subject    <subject>
  1765.  
  1766.     Subject used for the Annoucement message.
  1767.  
  1768.     The files are announced in every area defined via the Announce
  1769.     statement.
  1770.        
  1771. In future versions of the Ticker UseNetNaming and MsgBase will become a
  1772. meaning when autoadding of fileareas will be implemented.
  1773.  
  1774. RECOGNIZED FLAGS IN TICKECHO.BBS
  1775. ================================
  1776.  
  1777. The format of the TICKECHO.BBS file is in most parts identical to the
  1778. AREAS.BBS file. The path of the filearea is followed by the areaname and
  1779. the connected nodes. As in AREAS.BBS you can specify special areaflags
  1780. before the main entry. In addition you must specify the mailflavour and
  1781. permissions after every node.
  1782.  
  1783. Example:
  1784.  
  1785.     F:\FAN\UTIL\MISC\ FAN.UTIL.MISC 2:246/1300@fidonet.org HRS 244/4344 HS
  1786.  
  1787.     Flavour flags:
  1788.  
  1789.     O: Normal      (OFT)
  1790.     H: Hold        (HFT)
  1791.     I: Immediate   (IFT)
  1792.     C: Crash       (CFT)
  1793.  
  1794.     Security flags:
  1795.  
  1796.     R: Receive (link is allowed to send files into this area)
  1797.     S: Send (Files are send to the link)
  1798.  
  1799. Not all of the following features for the JetMail ticker are yet 
  1800. implemented.
  1801. In most cases you will find keywords you already know from AREAS.BBS.
  1802.  
  1803. -Days           <number>
  1804.  
  1805.     Files older <than> number of days will be deleted during crunch.
  1806.     Files are never deleted if no -Days keyword is present.
  1807.    
  1808.     [Not yet implemented]
  1809.    
  1810. -Desc           <string>
  1811.  
  1812.     Description of the area. Send to users within FileFix requests.
  1813.  
  1814. -Password       <password>
  1815.  
  1816.     Defines a special access password for this area (and has nothing to do
  1817.     with the password which is places in the TIC file).
  1818.    
  1819. -Group          <character>
  1820.  
  1821.     Classifies the group for this area. Only nodes with the appropiate group
  1822.     in his Groups statement can connect.
  1823.  
  1824. -ForceConnect   <patterns>
  1825. -NoForce        <patterns>
  1826. -NoConnect      <patterns>
  1827. -NoDisconnect   <patterns>
  1828.  
  1829.     Exactly the same meaning as in your AREAS.BBS file.
  1830.  
  1831. -UseAlias       <full_5D_address>
  1832.  
  1833.     Use this address for the From field in TIC.
  1834.  
  1835. -Stripseenby
  1836.  
  1837.     Strip SEEN-BY lines in this areas. Only usefull for ZoneGates.
  1838.     !!!!!!!!!!!!!!!!!! Must be permitted by the ZC !!!!!!!!!!!!!!!
  1839.  
  1840. -NoFilesBBS
  1841.  
  1842.     Don't write an entry to FILES.BBS file. Useful for areas like the
  1843.     nodelist distribution.
  1844.    
  1845. -NoAddAkas
  1846.  
  1847.     Don't add all your AKA's for Seenby lines in TIC.
  1848.  
  1849. -GateTo         <areatags>
  1850.  
  1851.     Works exactly like echomail gating.
  1852.  
  1853.     [Not yet implemented]
  1854.    
  1855. -NoAnnounce
  1856.  
  1857.     Prevents files in this area to be announced.
  1858.     
  1859.  
  1860. MENTAL SUPPORT:
  1861. ===============
  1862.  
  1863. This software was written while listening to:
  1864.  
  1865. Rage against the machine
  1866. Clawfinger
  1867. Dream Theater
  1868. U2
  1869. Pearl Jam
  1870. Guns N' Roses
  1871. Red Hot Chilli Peppers
  1872. Sophie B. Hawkins
  1873. Joe Satriani
  1874. Soul Asylum
  1875. MTV
  1876. etc...
  1877.  
  1878. Special thanx to the Jack Daniel's distillery for their great stuff!
  1879. ;-)
  1880.